home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The Datafile PD-CD 1 Issue 2
/
PDCD-1 - Issue 02.iso
/
_utilities
/
utilities
/
001
/
_fsp
/
!FSPConv
/
Help
/
General
< prev
next >
Wrap
Text File
|
1994-01-15
|
4KB
|
118 lines
Help For FSPConv
================
FSPConv prepares sprite files for use by the module FastSpr. The FastSpr
module provides high speed sprite plotting with clipping and masking, and
has proven reliable in the commercial field. FastSpr version 2.00 may be
used with no royalty payments for both commercial and non-commercial
applications. FastSpr can be obtained from most PD libraries.
Using FSPConv
=============
FSPConv converts a normal sprite file into a FastSpr file. A typical FastSprfile would be created like this:
Å Create a sprite file using paint, with sprites named 0,1,2,3,4,5 etc...
Å Drag this file to the FSPConv icon.
Å A sprite window and a conversion window should appear. The conversion
window has a save destination filename, which by default is the sprite
filename with FSP inserted before the final name (the 'leafname').
Å If you want to, drag the FastSpr file icon to a filer window to change the
save destination, in the usual way.
Å You may now click the 'Convert' button the begin conversion.
Å Bazaam!!! FSPConv should do the business.
You may close the conversion window if you want to mess about with your
sprites before converting them.
As you might guess, telling FastSpr to plot sprite 0 will plot the sprite
which was originally called '0'.
BIG NOTE: FSPConv cannot convert a FastSpr file BACK into a normal sprite
file, so keep a copy of your normal sprite file to edit your sprites.
Transparency
============
Sprite masks are ignored, as they double the size of your sprite files.
Instead, one colour, usually colour 0, is taken to be transparent. This may
be altered on the icon bar menu if you wish.
Limitations
===========
Both FSPConv and FastSpr were designed with 256 colour sprites in mind. They
both 'should' cope with 2,4 and 16 colour modes but the horizontal position
resolution is reduced (FastSpr takes coordinates of the form lines down,
BYTES across).
You canæt yet drag a file from a !Paint save window straight to FSPConv.
Sprite palletes are ignored. This makes the 16 colour ones look a bit
bizarre in the sprite window, but the still convert OK.
FSPConv will run out of memory if you have sprites numbered over 1000 or so.
The best cure is to have lower sprite numbers as excessively large numbers
waste memory and disc space, but if you must, change the WimpSlot in
FSPConvæs !Run file.
The Quick Test
==============
Try this:
Å Use !Paint to make a sprite file with a sprite named 0 which is, say width
16, height 16, in mode 13. Be artistic!
Å Save it with the name 'Sprites' in the root directory of your disc (the
one that opens when you click on the disc icon).
Å Drag this file to the FSPConv icon.
Å Click convert.
Å Double click on the !FastSpr icon.
Å Press F12.
Å Type 'FastSprLoad FSPSprites' (without the quotes).
Å Get an error message? Type 'Mount' and try again.
Å Type 'BASIC'
Å Type 'MODE 13' (capitals).
Å Type 'SYS "FastSpr_Plot",0,150,150' with all the capitals in the right
places.
If all is well, your sprite should the appear on the screen.
Status
======
FSPConv is public domain and may be freely distributed. The program was
written in C and compiled with Acorn C version 3.00, so it should work with
RISC OS 2 provided you have a copy of the Shared C Library 3.50 or greater
and Colourtrans.
Bugs
====
I donæt know of any serious ones, but Iæd like to know if you find any.
FastSpr is known to have problems (address exceptions etc) in the following
situations:
Å If the screen is scrolled.
Å If you try to use two screen banks but donæt have sufficient memory
allocated.
Å You use the *Shadow command.
Å You use commands like MODE 128+13 (use MODE 15:MODE 13 instead).
Please send your bug reports, both for FastSpr and FSPConv, to:
Andy Southgate
14 Madingley Road
Cambridge
CB3 0EE
or Email as142@cus.cam.ac.uk
If you could send me the sprite file which causes the problem, so much the
better.
Good luck!
Andy.